home *** CD-ROM | disk | FTP | other *** search
/ Celestin Apprentice 5 / Apprentice-Release5.iso / Environments / RAMSES 2.2 / RAMSES 2.2 Extras / Alpha Editor Support / Modula-2 Help < prev    next >
Text File  |  1996-07-08  |  5KB  |  172 lines
  1. ==============================================================================
  2. = Working with Modula-2 Files
  3. ==============================================================================
  4.  
  5. Alpha will automatically switch into "Modula-2 Mode" or "M2 Mode" if you 
  6. open a file with the ending .MOD, .mod, .DEF, or .def.  If you start from 
  7. scratch with menu command New or with any other file having a different 
  8. extension and you wish to activate "M2 Mode", you can always achieve this 
  9. by simply chooseing the "M2 Mode" in the Mode PopUp menu (down arrow) in 
  10. top right corner of the window.  As soon you are in the "M2 Mode" an 
  11. additional menu, named M2, is inserted in the menubar, which offers you the 
  12. M2-support (for keyboard shortcuts (key bindings) see below).
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.  
  25.  
  26.  
  27.  
  28.  
  29.  
  30.  
  31.  
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40. ==============================================================================
  41. = Typing and Templates
  42. ==============================================================================
  43.  
  44. Alpha examines every keystroke when you are in Modula mode. It will expand your
  45. typing automaticly.
  46. For example: FOR(Space)i(Return)0(Return)9(Return) will give
  47. FOR i := 0 TO 9 DO
  48.  
  49. END;(*FOR*)
  50. and the cursor placed is below FOR indented by modulaIndent (which is 
  51. defined in the file userStartup.tcl).
  52.  
  53. The Return-Key will NOT break the current line. Shift-Return will break the 
  54. line at the current position.
  55.  
  56. ESC followed by Space will expand the current word, if there is an
  57. equivalent in the reserved word list, or if there is a word in the text 
  58. starting with the current word. The latter is searched first above and 
  59. the below.
  60.  
  61. For example: PROC(ESC)(Space) will result in PROCEDURE
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.  
  71.  
  72.  
  73.  
  74.  
  75.  
  76.  
  77. ==============================================================================
  78. = "M2 Mode" specific keyboard shortcuts (keyboard bindings)
  79. ==============================================================================
  80.  
  81. CTRL-1            Launch MacMETH or RAMSES Shell (depending on current configuration).
  82. CTRL-0            Open recently compiled Modula-2 source file (or all with errors).
  83. CTRL-j/CTRL-e    Jump to next error.
  84. CTRL-g            Jump to the next Placeholder (*. text .*).
  85. CTRL-SHIFT-g    Jump to the previous Placeholder.
  86. CTRL-m            Select the current line; expand with SHIFT-cursorUP/cursorDOWN 
  87. CTRL-BACKSPACE    Kills the entire current line
  88. OPT-BACKSPACE    Kills the current line from the cursor position to the end
  89. TAB                Insert indentation spaces (same as CTRL-r, configurable).
  90. CTRL-k            Comment selection in the form (*. selection .*)
  91. CTRL-SHIFT-k    Uncomment selection, must be in the form (*. text .*)
  92. CTRL-r/OPT-]    Shift lines in selection to the right (by indentation spaces).
  93. CTRL-l/OPT-[    Shift lines in selection to the left (by half indentation spaces).
  94. CTRL-a            Wrap selected Modula-2 comment. The result is in the form:
  95.                 (*
  96.                   comment
  97.                 *)
  98. CTRL-SHIFT-a    Wrap selected Text. The left margin is the position of the first
  99.                 non white-space character in the selection
  100.  
  101. CTRL-HOME        Jump to the beginning of the file.
  102. CTRL-END        Jump to the end of the file.
  103. CTRL-LEFT        Backward one word.
  104. CTRL-RIGHT        Forward one word.
  105.  
  106. These shortcuts have been designed similar to the ones of MEdit, mainly for 
  107. those user's using both editors (see RAMSES software package); simply use 
  108. the control key instead of command.  Note also, MEdit's shortcuts have been 
  109. designed after the MPW user interface.
  110.  
  111.  
  112.  
  113.  
  114.  
  115. ==============================================================================
  116. = Installation
  117. ==============================================================================
  118. Instructions on how to install the Modula-2 support in Alpha are given in
  119. a separate file named "READ ME Installation.tcl" which is available as 
  120. part of the "RAMSES Extra" release (ftp.ito.umnw.ethz.ch). 
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128. ==============================================================================
  129. = Customizing
  130. ==============================================================================
  131. The Modula-2 extension for the alpha editor is customizable by the file
  132. Prefs.tcl or by changing the Modula2.tcl: 
  133.  
  134. • Some customization is done by the commands "Configure Launching" and 
  135. "Configure" in the M2 menu.  "Configure Launching" lets you select the 
  136. shell to which the launch commands (CTRL-1, CTRL-2) will transfer, and to 
  137. choose the file which contains the messages which help you to interpret the 
  138. compiler generated error codes.  "Configure" lets you enter your name used 
  139. by defaults in module templates, to set tab spaces (shift right, shift left 
  140. respectively).
  141.  
  142. • Editing Prefs.tcl:
  143. Open prefs.tcl (see Alpha's menu command "Edit Prefs.tcl" 
  144. under menu "Edit") and add for instance the following line
  145.  
  146.      set defaultFont Programmer
  147.  
  148. for having that useful font ready for your Modula-2 programming. 
  149. Or you can define the variable modulaIndent by:
  150.  
  151.      set modulaIndent "  "
  152.  
  153. The content of this variable is used for indentation, or is inserted when 
  154. you press tab.
  155. etc.
  156.  
  157.  
  158.  
  159.  
  160.  
  161.  
  162.  
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.